---
title: 오류 참조
i18nReady: true
githubURL: https://github.com/withastro/astro/blob/main/packages/astro/src/core/errors/errors-data.ts
---

import DontEditWarning from '~/components/DontEditWarning.astro'

다음 참조는 Astro를 사용하는 동안 발생할 수 있는 오류의 전체 목록입니다. 일반적인 문제를 포함한 추가 지원이 필요하면 [문제 해결 가이드](/ko/guides/troubleshooting/)도 참조하세요.

## Astro 오류

- [**CantUseAstroConfigModuleError**](/ko/reference/errors/cant-use-astro-config-module-error/)<br/>실험적 기능을 활성화하지 않으면 `astro:config` 모듈을 사용할 수 없습니다.
- [**UnknownCompilerError**](/ko/reference/errors/unknown-compiler-error/)<br/>알 수 없는 컴파일러 오류입니다.
- [**ClientAddressNotAvailable**](/ko/reference/errors/client-address-not-available/)<br/>현재 어댑터에서는 `Astro.clientAddress`를 사용할 수 없습니다.
- [**PrerenderClientAddressNotAvailable**](/ko/reference/errors/prerender-client-address-not-available/)<br/>`Astro.clientAddress`는 사전 렌더링된 경로에서 사용할 수 없습니다.
- [**StaticClientAddressNotAvailable**](/ko/reference/errors/static-client-address-not-available/)<br/>`Astro.clientAddress`는 미리 렌더링된 페이지에서 사용할 수 없습니다.
- [**NoMatchingStaticPathFound**](/ko/reference/errors/no-matching-static-path-found/)<br/>요청한 경로에 대한 정적 경로를 찾을 수 없습니다.
- [**OnlyResponseCanBeReturned**](/ko/reference/errors/only-response-can-be-returned/)<br/>Astro 페이지에서 잘못된 타입을 반환했습니다.
- [**MissingMediaQueryDirective**](/ko/reference/errors/missing-media-query-directive/)<br/>`client:media` 지시어의 값이 누락되었습니다.
- [**NoMatchingRenderer**](/ko/reference/errors/no-matching-renderer/)<br/>일치하는 렌더러를 찾을 수 없습니다.
- [**NoClientEntrypoint**](/ko/reference/errors/no-client-entrypoint/)<br/>렌더러에 지정된 클라이언트 엔트리포인트가 없습니다.
- [**NoClientOnlyHint**](/ko/reference/errors/no-client-only-hint/)<br/>`client:only` 지시어에 대한 힌트가 누락되었습니다.
- [**InvalidGetStaticPathParam**](/ko/reference/errors/invalid-get-static-path-param/)<br/>`getStaticPaths` 경로에서 반환된 값이 잘못되었습니다.
- [**InvalidGetStaticPathsEntry**](/ko/reference/errors/invalid-get-static-paths-entry/)<br/>getStaticPath의 반환 값에 잘못된 항목이 있습니다.
- [**InvalidGetStaticPathsReturn**](/ko/reference/errors/invalid-get-static-paths-return/)<br/>getStaticPaths에서 잘못된 값을 반환했습니다.
- [**GetStaticPathsExpectedParams**](/ko/reference/errors/get-static-paths-expected-params/)<br/>`getStaticPaths` 경로에 매개변수 속성이 누락되었습니다.
- [**GetStaticPathsInvalidRouteParam**](/ko/reference/errors/get-static-paths-invalid-route-param/)<br/>`getStaticPaths` 경로 매개변수 값이 잘못되었습니다.
- [**GetStaticPathsRequired**](/ko/reference/errors/get-static-paths-required/)<br/>동적 경로에는 `getStaticPaths()` 함수가 필요합니다.
- [**ReservedSlotName**](/ko/reference/errors/reserved-slot-name/)<br/>슬롯 이름이 잘못되었습니다.
- [**NoAdapterInstalled**](/ko/reference/errors/no-adapter-installed/)<br/>어댑터 없이는 서버 측 렌더링을 사용할 수 없습니다.
- [**AdapterSupportOutputMismatch**](/ko/reference/errors/adapter-support-output-mismatch/)<br/>어댑터가 서버 출력을 지원하지 않습니다.
- [**NoAdapterInstalledServerIslands**](/ko/reference/errors/no-adapter-installed-server-islands/)<br/>어댑터 없이 서버 아일랜드를 사용할 수 없습니다.
- [**NoMatchingImport**](/ko/reference/errors/no-matching-import/)<br/>컴포넌트에 대한 가져오기를 찾을 수 없습니다.
- [**InvalidPrerenderExport**](/ko/reference/errors/invalid-prerender-export/)<br/>사전 렌더링 내보내기가 잘못되었습니다.
- [**InvalidComponentArgs**](/ko/reference/errors/invalid-component-args/)<br/>컴포넌트 인수가 잘못되었습니다.
- [**PageNumberParamNotFound**](/ko/reference/errors/page-number-param-not-found/)<br/>페이지 번호 매개변수를 찾을 수 없습니다.
- [**ImageMissingAlt**](/ko/reference/errors/image-missing-alt/)<br/>이미지에 필수 "alt" 속성이 누락되었습니다.
- [**InvalidImageService**](/ko/reference/errors/invalid-image-service/)<br/>이미지 서비스를 로드하는 중 오류가 발생했습니다.
- [**MissingImageDimension**](/ko/reference/errors/missing-image-dimension/)<br/>이미지 크기가 누락되었습니다.
- [**FailedToFetchRemoteImageDimensions**](/ko/reference/errors/failed-to-fetch-remote-image-dimensions/)<br/>원격 이미지 크기를 검색하지 못했습니다.
- [**UnsupportedImageFormat**](/ko/reference/errors/unsupported-image-format/)<br/>지원되지 않는 이미지 형식
- [**UnsupportedImageConversion**](/ko/reference/errors/unsupported-image-conversion/)<br/>지원되지 않는 이미지 변환
- [**PrerenderDynamicEndpointPathCollide**](/ko/reference/errors/prerender-dynamic-endpoint-path-collide/)<br/>사전 렌더링된 동적 엔드포인트에 경로 충돌이 있습니다.
- [**PrerenderRouteConflict**](/ko/reference/errors/prerender-route-conflict/)<br/>사전 렌더링된 라우트가 다른 라우트와 동일한 경로를 생성합니다.
- [**ExpectedImage**](/ko/reference/errors/expected-image/)<br/>src는 이미지일 것으로 예상됩니다.
- [**ExpectedImageOptions**](/ko/reference/errors/expected-image-options/)<br/>예상되는 이미지 옵션.
- [**ExpectedNotESMImage**](/ko/reference/errors/expected-not-esmimage/)<br/>ESM에서 가져온 이미지가 아닌 예상되는 이미지 옵션.
- [**IncompatibleDescriptorOptions**](/ko/reference/errors/incompatible-descriptor-options/)<br/>`densities` 및 `widths`를 모두 설정할 수 없습니다.
- [**ImageNotFound**](/ko/reference/errors/image-not-found/)<br/>이미지를 찾을 수 없습니다.
- [**NoImageMetadata**](/ko/reference/errors/no-image-metadata/)<br/>이미지 메타데이터를 처리할 수 없습니다.
- [**CouldNotTransformImage**](/ko/reference/errors/could-not-transform-image/)<br/>이미지를 변환할 수 없습니다.
- [**ResponseSentError**](/ko/reference/errors/response-sent-error/)<br/>응답을 설정할 수 없습니다.
- [**MiddlewareNoDataOrNextCalled**](/ko/reference/errors/middleware-no-data-or-next-called/)<br/>미들웨어가 `Response`를 반환하지 않았습니다.
- [**MiddlewareNotAResponse**](/ko/reference/errors/middleware-not-aresponse/)<br/>미들웨어가 `Response` 객체가 아닌 것을 반환했습니다.
- [**EndpointDidNotReturnAResponse**](/ko/reference/errors/endpoint-did-not-return-aresponse/)<br/>엔드포인트가 `Response`를 반환하지 않았습니다.
- [**LocalsNotAnObject**](/ko/reference/errors/locals-not-an-object/)<br/>`locals`에 할당된 값은 허용되지 않습니다.
- [**LocalsReassigned**](/ko/reference/errors/locals-reassigned/)<br/>`locals`에 재할당할 수 없습니다.
- [**AstroResponseHeadersReassigned**](/ko/reference/errors/astro-response-headers-reassigned/)<br/>`Astro.response.headers`는 재할당되어서는 안 됩니다.
- [**MiddlewareCantBeLoaded**](/ko/reference/errors/middleware-cant-be-loaded/)<br/>미들웨어를 로드할 수 없습니다.
- [**LocalImageUsedWrongly**](/ko/reference/errors/local-image-used-wrongly/)<br/>로컬 이미지를 가져와야 합니다.
- [**AstroGlobUsedOutside**](/ko/reference/errors/astro-glob-used-outside/)<br/>Astro.glob()은 Astro 파일 외부에서 사용됩니다.
- [**AstroGlobNoMatch**](/ko/reference/errors/astro-glob-no-match/)<br/>Astro.glob()과 일치하는 파일이 없습니다.
- [**RedirectWithNoLocation**](/ko/reference/errors/redirect-with-no-location/)<br/>리디렉션에는 `Location` 헤더가 있는 location이 제공되어야 합니다.
- [**UnsupportedExternalRedirect**](/ko/reference/errors/unsupported-external-redirect/)<br/>지원되지 않거나 잘못된 URL입니다.
- [**InvalidDynamicRoute**](/ko/reference/errors/invalid-dynamic-route/)<br/>동적 경로가 잘못되었습니다.
- [**MissingSharp**](/ko/reference/errors/missing-sharp/)<br/>Sharp를 찾을 수 없습니다.
- [**UnknownViteError**](/ko/reference/errors/unknown-vite-error/)<br/>알 수 없는 Vite 오류입니다.
- [**FailedToLoadModuleSSR**](/ko/reference/errors/failed-to-load-module-ssr/)<br/>파일을 가져올 수 없습니다.
- [**InvalidGlob**](/ko/reference/errors/invalid-glob/)<br/>잘못된 glob 패턴입니다.
- [**FailedToFindPageMapSSR**](/ko/reference/errors/failed-to-find-page-map-ssr/)<br/>Astro가 렌더링할 올바른 페이지를 찾을 수 없습니다.
- [**MissingLocale**](/ko/reference/errors/missing-locale/)<br/>제공된 언어가 존재하지 않습니다.
- [**MissingIndexForInternationalization**](/ko/reference/errors/missing-index-for-internationalization/)<br/>색인 페이지를 찾을 수 없습니다.
- [**IncorrectStrategyForI18n**](/ko/reference/errors/incorrect-strategy-for-i18n/)<br/>현재 전략에는 현재 함수를 사용할 수 없습니다
- [**NoPrerenderedRoutesWithDomains**](/ko/reference/errors/no-prerendered-routes-with-domains/)<br/>국제화 도메인이 활성화된 경우 사전 렌더링된 경로는 지원되지 않습니다.
- [**MissingMiddlewareForInternationalization**](/ko/reference/errors/missing-middleware-for-internationalization/)<br/>미들웨어 없이 수동 국제화 라우팅을 활성화했습니다.
- [**CantRenderPage**](/ko/reference/errors/cant-render-page/)<br/>Astro가 경로를 렌더링할 수 없습니다.
- [**UnhandledRejection**](/ko/reference/errors/unhandled-rejection/)<br/>처리될 수 없는 오류가 발생했습니다.
- [**i18nNotEnabled**](/ko/reference/errors/i18n-not-enabled/)<br/>i18n이 활성화되지 않았습니다.
- [**i18nNoLocaleFoundInPath**](/ko/reference/errors/i18n-no-locale-found-in-path/)<br/>경로에 로케일이 포함되어 있지 않습니다.
- [**RouteNotFound**](/ko/reference/errors/route-not-found/)<br/>경로를 찾을 수 없습니다.
- [**EnvInvalidVariables**](/ko/reference/errors/env-invalid-variables/)<br/>잘못된 환경 변수
- [**ServerOnlyModule**](/ko/reference/errors/server-only-module/)<br/>모듈은 서버 측에서만 사용할 수 있습니다.
- [**RewriteWithBodyUsed**](/ko/reference/errors/rewrite-with-body-used/)<br/>요청 본문을 읽은 후에는 Astro.rewrite를 사용할 수 없습니다.
- [**ForbiddenRewrite**](/ko/reference/errors/forbidden-rewrite/)<br/>정적 라우트에서 리라이트는 금지되어 있습니다.
- [**UnknownFilesystemError**](/ko/reference/errors/unknown-filesystem-error/)<br/>디스크에 파일을 읽거나 쓰는 동안 알 수 없는 오류가 발생했습니다.
- [**CannotExtractFontType**](/ko/reference/errors/cannot-extract-font-type/)<br/>주어진 URL에서 글꼴 유형을 추출할 수 없습니다.
- [**CannotDetermineWeightAndStyleFromFontFile**](/ko/reference/errors/cannot-determine-weight-and-style-from-font-file/)<br/>글꼴 파일에서 굵기와 스타일을 결정할 수 없습니다.
- [**CannotFetchFontFile**](/ko/reference/errors/cannot-fetch-font-file/)<br/>제공된 글꼴 파일을 가져올 수 없습니다.
- [**CannotLoadFontProvider**](/ko/reference/errors/cannot-load-font-provider/)<br/>글꼴 제공자를 로드할 수 없습니다.
- [**ExperimentalFontsNotEnabled**](/ko/reference/errors/experimental-fonts-not-enabled/)<br/>실험적인 글꼴 기능이 활성화되지 않았습니다.
- [**FontFamilyNotFound**](/ko/reference/errors/font-family-not-found/)<br/>글꼴 패밀리를 찾을 수 없습니다.
- [**CspNotEnabled**](/ko/reference/errors/csp-not-enabled/)<br/>CSP 기능이 활성화되지 않았습니다.

## CSS 오류

- [**UnknownCSSError**](/ko/reference/errors/unknown-csserror/)<br/>알 수 없는 CSS 오류입니다.
- [**CSSSyntaxError**](/ko/reference/errors/csssyntax-error/)<br/>CSS 구문 오류.

## Markdown 오류

- [**UnknownMarkdownError**](/ko/reference/errors/unknown-markdown-error/)<br/>알 수 없는 Markdown 오류입니다.
- [**MarkdownFrontmatterParseError**](/ko/reference/errors/markdown-frontmatter-parse-error/)<br/>Markdown 프런트매터를 구문 분석하지 못했습니다.
- [**InvalidFrontmatterInjectionError**](/ko/reference/errors/invalid-frontmatter-injection-error/)<br/>잘못된 프론트매터 삽입입니다.
- [**MdxIntegrationMissingError**](/ko/reference/errors/mdx-integration-missing-error/)<br/>MDX 통합이 누락되었습니다.
- [**UnknownConfigError**](/ko/reference/errors/unknown-config-error/)<br/>알 수 없는 구성 오류입니다.
- [**ConfigNotFound**](/ko/reference/errors/config-not-found/)<br/>지정된 구성 파일을 찾을 수 없습니다.
- [**ConfigLegacyKey**](/ko/reference/errors/config-legacy-key/)<br/>레거시 구성이 감지되었습니다.

## CLI 오류

- [**UnknownCLIError**](/ko/reference/errors/unknown-clierror/)<br/>알 수 없는 CLI 오류.
- [**GenerateContentTypesError**](/ko/reference/errors/generate-content-types-error/)<br/>콘텐츠 타입을 생성하지 못했습니다.

## 콘텐츠 컬렉션 오류

- [**UnknownContentCollectionError**](/ko/reference/errors/unknown-content-collection-error/)<br/>알 수 없는 콘텐츠 컬렉션 오류입니다.
- [**RenderUndefinedEntryError**](/ko/reference/errors/render-undefined-entry-error/)<br/>정의되지 않은 콘텐츠 컬렉션 항목을 렌더링하려고 했습니다.
- [**GetEntryDeprecationError**](/ko/reference/errors/get-entry-deprecation-error/)<br/>`getDataEntryById` 또는 `getEntryBySlug` 함수를 잘못 사용했습니다.
- [**InvalidContentEntryFrontmatterError**](/ko/reference/errors/invalid-content-entry-frontmatter-error/)<br/>콘텐츠 항목 프런트매터가 스키마와 일치하지 않습니다.
- [**InvalidContentEntryDataError**](/ko/reference/errors/invalid-content-entry-data-error/)<br/>콘텐츠 항목 데이터가 스키마와 일치하지 않습니다.
- [**ContentLoaderReturnsInvalidId**](/ko/reference/errors/content-loader-returns-invalid-id/)<br/>콘텐츠 로더가 유효하지 않은 `id`를 가진 항목을 반환했습니다.
- [**ContentEntryDataError**](/ko/reference/errors/content-entry-data-error/)<br/>콘텐츠 항목 데이터가 스키마와 일치하지 않습니다.
- [**LiveContentConfigError**](/ko/reference/errors/live-content-config-error/)<br/>라이브 콘텐츠 구성에서 오류가 발생했습니다.
- [**ContentLoaderInvalidDataError**](/ko/reference/errors/content-loader-invalid-data-error/)<br/>콘텐츠 항목에 ID가 누락되었습니다.
- [**InvalidContentEntrySlugError**](/ko/reference/errors/invalid-content-entry-slug-error/)<br/>잘못된 콘텐츠 항목 슬러그입니다.
- [**ContentSchemaContainsSlugError**](/ko/reference/errors/content-schema-contains-slug-error/)<br/>콘텐츠 스키마에는 `slug`가 포함되어서는 안 됩니다.
- [**MixedContentDataCollectionError**](/ko/reference/errors/mixed-content-data-collection-error/)<br/>콘텐츠와 데이터는 동일한 컬렉션에 포함될 수 없습니다.
- [**ContentCollectionTypeMismatchError**](/ko/reference/errors/content-collection-type-mismatch-error/)<br/>컬렉션에 다른 타입의 항목이 포함되어 있습니다.
- [**DataCollectionEntryParseError**](/ko/reference/errors/data-collection-entry-parse-error/)<br/>데이터 컬렉션 항목을 구문 분석하지 못했습니다.
- [**DuplicateContentEntrySlugError**](/ko/reference/errors/duplicate-content-entry-slug-error/)<br/>콘텐츠 항목 슬러그가 중복되었습니다.
- [**UnsupportedConfigTransformError**](/ko/reference/errors/unsupported-config-transform-error/)<br/>콘텐츠 구성에서 지원되지 않는 변환입니다.
- [**FileParserNotFound**](/ko/reference/errors/file-parser-not-found/)<br/>파일 구문 분석기를 찾을 수 없습니다.
- [**FileGlobNotSupported**](/ko/reference/errors/file-glob-not-supported/)<br/>Glob 패턴은 파일 로더에서 지원되지 않습니다.

## 액션 오류

- [**ActionsWithoutServerOutputError**](/ko/reference/errors/actions-without-server-output-error/)<br/>액션은 서버 출력과 함께 사용해야 합니다.
- [**ActionsReturnedInvalidDataError**](/ko/reference/errors/actions-returned-invalid-data-error/)<br/>액션 핸들러가 잘못된 데이터를 반환했습니다.
- [**ActionNotFoundError**](/ko/reference/errors/action-not-found-error/)<br/>액션을 찾을 수 없습니다.
- [**ActionCalledFromServerError**](/ko/reference/errors/action-called-from-server-error/)<br/>서버에서 예기치 않은 액션이 호출되었습니다.
- [**ActionsCantBeLoaded**](/ko/reference/errors/actions-cant-be-loaded/)<br/>Astro 액션을 로드할 수 없습니다.

## 세션 오류

- [**SessionWithoutSupportedAdapterOutputError**](/ko/reference/errors/session-without-supported-adapter-output-error/)<br/>서버 출력을 지원하지 않는 어댑터에서는 세션을 사용할 수 없습니다.
- [**SessionStorageInitError**](/ko/reference/errors/session-storage-init-error/)<br/>세션 스토리지를 초기화할 수 없습니다.
- [**SessionStorageSaveError**](/ko/reference/errors/session-storage-save-error/)<br/>세션 데이터를 저장할 수 없습니다.
- [**SessionWithoutSupportedAdapterOutputError**](/ko/reference/errors/session-without-supported-adapter-output-error/)<br/>세션은 서버 출력을 지원하지 않는 어댑터와 함께 사용할 수 없습니다.
- [**SessionConfigMissingError**](/ko/reference/errors/session-config-missing-error/)<br/>세션 스토리지가 활성화되었지만 구성되지 않았습니다.
- [**SessionConfigWithoutFlagError**](/ko/reference/errors/session-config-without-flag-error/)<br/>세션 플래그가 설정되지 않았습니다.
- [**CannotOptimizeSvg**](/ko/reference/errors/cannot-optimize-svg/)<br/>SVG를 최적화할 수 없습니다.
